home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 25 / CU Amiga Magazine's Super CD-ROM 25 (1998)(EMAP Images)(GB)(Track 1 of 2)[!][issue 1998-08].iso / CUCD / Programming / EasyReq / EasyReq.ReadMe < prev    next >
Encoding:
Text File  |  1998-06-15  |  3.1 KB  |  101 lines
  1. EasyRequest-module by Deniil 715!
  2.  
  3.  
  4. What is it?
  5. ~~~~~~~~~~~
  6. EasyReq_oo.m contains a class that uses the EasyRequestArgs() to
  7. in an easy way use requesters.
  8.  
  9.  
  10. Usage of the class methods:
  11. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  12. DEF er:PTR TO easyreq
  13.  
  14. -----------------
  15. easyreq(defmenu,defgads) -> This is the constructor to the class.
  16. ^^^^^^^
  17. Usage: NEW er.easyreq() -> will initiate the timer with default values.
  18.  
  19. 'defmenu' is a strptr to what you want to bee seen in the menu of
  20.           the requester-window.  F.ex. you programs name.
  21. 'defgads' is a strptr to a string containing the gadgets you want
  22.           in the requester if you don't specifies any in req().
  23.           Default is 'OK'.
  24.  
  25. -----------------
  26.  
  27. req(text,gads=NIL,args=NIL,menu=NIL) -> This will open a requester
  28. ^^^                                     with proper parameters.
  29.  
  30. Usage: er.req('Do you want to quit?',
  31.               'Yes|No') -> Will open a requester with the specified
  32.                            text and the current specified gadgets and
  33.                            the default menu.
  34.  
  35. 'text' is a strptr to the text you want in the requester.
  36. 'gads' is a strptr to the gadgets you want, seperated by a '|'.
  37.        If ignored, the defgads will be used.
  38. 'args' a list that you can specify like this: [x,'a string'] if you
  39.        somewhere in the 'tex' have a %d and %s.
  40. 'menu' is a strptr to temporary change the menu in this call to req()
  41.  
  42. -----------------
  43.  
  44. chgmenugads(newmeny,newgads=NIL) -> Will change the default strings
  45. ^^^^^^^^^^^                         of the menu and gadgets.
  46.  
  47. Usage: er.chgmenugads('A new menu!',
  48.                       'Quit|Save') -> This will change the default
  49.                                       menu- and gadget-settings made
  50.                                       in the constructor.
  51.  
  52. 'newmenu' is a strptr to the new default menu.
  53. 'newgads' is a strptr to the new default gadgets.
  54. -----------------
  55.  
  56. setadvanced(win=NIL,idcmp_ptr=NIL,arglist=NIL) -> will set some more
  57. ^^^^^                                             advanced features of
  58.                                                   EasyRequestArgs().
  59. Usage: er.setadvanced(winOnScr) -> will make the next requester to
  60.                                    open on the same screen as the
  61.                                    winOnScr window is opened on.
  62.  
  63. 'win' is a window-pointer to a window that lies on a screen that you
  64.       wich to open your next requester on.
  65. 'idcmp_ptr' is a PTR TO LONG where there should be some IDCMP-flags.
  66. 'arglist' is a pointer to a list of args that then would be default.
  67.  
  68. -----------------
  69.  
  70. end() -> the destructor
  71. ^^^^^^^^^^^^
  72.  
  73. Usage: END er
  74.  
  75. There is no point in calling er.end() yourself, use END er instead!
  76. -----------------
  77.  
  78.  
  79. Errors?
  80. ~~~~~~~
  81. Errors will be raised as exceptions.
  82.  
  83. Actually it may only raise one error and that is "EREQ" if out of
  84. memory while allocating the default strings.
  85.  
  86.  
  87. Author?
  88. ~~~~~~~
  89. Daniel Westerberg  alias  Deniil715!
  90. E-mail: deniil@algonet.se  or  onyxsoft@alfaskop.net
  91.  
  92.  
  93. Bugs?
  94. ~~~~~
  95. Don't think so ;)
  96. Report to author if you find anyone!  (please don't find any!!:)
  97.  
  98. It has been tested on:
  99. A1200 Blizz1230/50 OS39 2+16 MB Ram DBLPal ..
  100.  
  101.